home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1995 #12 / Monster Media No. 12 (Third Quarter 1995)(Monster Media, Inc.).ISO / monster / fview.doc < prev    next >
Text File  |  1994-01-20  |  8KB  |  202 lines
  1.                              FView Version 2.22
  2.                              -------------------
  3.                                Copyright  1994
  4.  
  5. COPYRIGHT NOTICE
  6.  
  7. This program is public domain and may be freely distributed, providing it is
  8. distributed in the original archive form (or variation thereof, such as a
  9. different archival program) and no charge is made for its redistribution,
  10. except where charges are made for copying services and/or diskettes. The author
  11. holds exclusive rights to the program. No warranty is made, neither expressed
  12. or implied, as to the suitability of the program for a particular purpose. The
  13. author shall not be liable for damages caused by the use, misuse, or abuse of
  14. this program. The program may not be reverse engineered, nor modified.
  15.  
  16.  
  17.  
  18. DESCRIPTION
  19. -----------
  20.  
  21. FView is a simple, text file viewer program. Since I didn't have one, nor was
  22. able to quite find the one I liked, I built my own. (Like they say, if you
  23. want something done right you gotta do it yourself.)
  24.  
  25.  
  26. USAGE
  27. -----
  28.  
  29. Starting the program is simple. From any DOS prompt, type:
  30.  
  31.  
  32.            FVIEW {-ns} {-b} filename
  33.  
  34.  
  35. This will scan through the specified file, then display it on screen. Much
  36. like DOS's edlin, the filename MUST be specified.
  37.  
  38. The options are as follows:
  39.  
  40. If the "-ns" option is specified, no scroll bars will be displayed and
  41. the mouse will not be enabled. Use this if the text file to be viewed
  42. contains lines of 80 characters and you wish to be able to view the entire
  43. line without having to scroll left and right.
  44.  
  45. If the "-b" option is specified, the program will use BIOS system calls to
  46. write to the screen, rather than its usual method of writing directly to
  47. the screen. This is useful when running FView through DOORWAY, for example,
  48. which may not update the user's screen properly (ie. the user at the other
  49. end of the modem). The option is not recommended for normal use, as using
  50. BIOS calls is significantly slower than writing directly to the computer's
  51. screen, particularly when running under Windows. However, going through a 
  52. modem, it wouldn't make a difference.
  53.  
  54.  
  55. NAVIGATING THROUGH THE FILE
  56. ---------------------------
  57.  
  58. New in version 2.2 is the addition of horizontal and vertical scroll bars,
  59. which show your relative position within the file. If you have a mouse, you
  60. can use the scroll bars to navigate through the file by clicking in the
  61. scroll bars (they work similar to Windows scroll bars).
  62.  
  63.  
  64. While viewing the document, you can scroll up/down/left/right/etc... using
  65. the cursor keys, page up/down keys, home and end keys (HOME takes you to the
  66. beginning of the file, END takes you to the bottom). As you move around, the
  67. current line and column will be display in the status bar.
  68.  
  69. Note that although the left and right cursor keys scroll a full screen rather
  70. than one character at a time (as the scrolling would be noticably slow), you
  71. can use the box in the horizontal scroll bar to move more precisely. Simply
  72. click on the position box and drag it left or right. Release it where you
  73. want it. This goes for the vertical scroll bar as well, so you can select
  74. exactly where in the file you want to view.
  75.  
  76. Status line:
  77.  
  78. Line    32 of   591 (  1- 79)                                       C:\TEXT.DAT
  79.      -----    -----  -------                  filename displayed here ^^^^^^^^^
  80.        |         |      |
  81.        |         |      +---------------- range of columns on screen
  82.        |         |                        (would be 80 chars if scroll bar
  83.        |         |                         turned off)
  84.        |         |
  85.        |         +----------------------- total number of lines in file
  86.        |
  87.        +--------------------------------- current line# of first line at the
  88.                                           top of the screen.
  89.  
  90. Help line:
  91.  
  92. The help line is used simply as a reminder of what keys may be used to
  93. scroll through the file, search through the file, or quit the program. The
  94. mouse may also be used to click on the help bar as opposed to using the keys
  95. for search and quit (the scroll bars only are used for scrolling).
  96.  
  97.  
  98. SEARCHING
  99. ---------
  100.  
  101. To search through a file, hit 'F', or click on 'F' or 'FIND' in the help line.
  102. This will bring up a box to type the text in that you wish to search for. When
  103. you hit ENTER, it will begin searching through the file, starting with the
  104. current line as indicated in the status bar at the top. To quit from the input
  105. box, hit ESC. Note that you cannot abort a search in progress.
  106.  
  107. While in the input box, standard editing keys are in effect, ie. left/right
  108. cursor keys, home/end, insert, etc. Use CTRL-HOME to erase the input and start
  109. over at the first position (CTRL-X also erases). When you first enter the box,
  110. the last text string (if any) you entered will be displayed. You can edit this
  111. string or start with a new one. If you begin typing characters immediately,
  112. before you move the cursor, the previous text string will be erased first.
  113.  
  114. To continue a search, hit 'N', or click on 'N' or 'NEXT' in the help line. This
  115. will continue the search from where the last text was found (even if you've
  116. scrolled it off the screen). If you hit 'N' before you've selected text with
  117. 'F', then a box will be displayed for you to enter the search text.
  118.  
  119. Similarly, hit 'P' or click on 'P' or 'PREV' in the help line to search
  120. backwards from the last found text. The program will beep if you have hit 'P'
  121. before entering text with 'F'.
  122.  
  123. In all 3 cases, if the text string is not found, it will beep and display
  124. "Search string not found". (It doesn't loop back around from the end of the
  125. file to the beginning, or vice-versa).
  126.  
  127.  
  128. QUIT
  129. ----
  130.  
  131. To leave the program, hit the ESCape key, or click on "ESC QUIT" in the help
  132. line. You will NOT be asked for confirmation.
  133.  
  134.  
  135.  
  136. NOTES
  137. -----
  138.  
  139. - If using FView through a bbs door (like DOORWAY), the scroll arrows on the
  140.   help line at the bottom of the screen and at the ends of the scroll bars
  141.   may not be displayed as arrows on the users' terminal. There are currently
  142.   no plans to fix this.
  143.  
  144. - The file being viewed is not actually read into memory. It is scanned and
  145.   the locations of the lines within the file are stored. For this reason,
  146.   when viewing a file from a floppy (or other removable media) do not remove
  147.   the diskette while viewing. This was to allow files of virtually any size
  148.   without memory constraints.
  149.  
  150. - Although the limit to the number of lines is 20,000, this has no relation
  151.   to the size of the file itself. A 512 byte buffer is used when reading in
  152.   lines, so theoretically you could view a file of 10,240,000 bytes in size.
  153.  
  154.  
  155. -------------------------
  156. Revision History
  157. -------------------------
  158.  
  159. Date           Version       Changes
  160.  
  161. February 1993  2.0           Added Search feature.
  162.                              Speeded up display when first scanning the file
  163.                              by only displaying the percentage in 5% increments.
  164.                              Changed method of programming by using a third
  165.                              party 'C' Window Library (freely distributable).
  166.  
  167. June 1993      2.1           Fixed problems with not displaying last line of a
  168.                              file.
  169.  
  170. September 1993 2.11          Doubled maximum # of lines from 10,000 to 20,000.
  171.  
  172. September 1993 2.2           Added scroll bars and mouse support.
  173.  
  174. October 1993   2.21          Added "-b" option for problems occurring using
  175.                              FView through the bbs program DOORWAY.
  176.  
  177. -------------------------
  178.  
  179.  
  180.  
  181. ---------------------
  182. Contacting the author
  183. ---------------------
  184.  
  185. I can reached via:
  186.  
  187. CompuServe:   70620,1445
  188. Internet:     plan9!bea77!cgordon@uunet.ca (preferred)
  189.          or   70620.1445@CompuServe.com
  190.          or   Chris_Gordon@MAGIC-BBS.corp.apple.com
  191.  
  192.  
  193. Chris Gordon
  194.  
  195.  
  196. ----------------
  197. Acknowledgements
  198. ----------------
  199.  
  200. P. A. McKenzie for the 'C' Window Library (Copyright 1990, 1991)
  201.  
  202.